home *** CD-ROM | disk | FTP | other *** search
/ Chip: 2005 Utilities / CHIP Utilities 2005 / CHIP Utilities 2005.iso / dosapps / freedos / help / choice.en < prev    next >
Encoding:
Text File  |  2003-03-06  |  1.5 KB  |  54 lines
  1. NAME
  2.  
  3.    CHOICE - Waits for the user to press a key, from a list of choices
  4.  
  5. SYNOPSIS
  6.  
  7.    CHOICE [/B] [/C[:]choices] [/N] [/S] [/T[:]c,nn] [text]
  8.  
  9. OPTIONS
  10.  
  11.  /B
  12.     Sounds an alert (beep) at prompt.
  13.  
  14.  /C[:]choices
  15.     Specifies allowable keys in the prompt.  When displayed, the keys
  16.     will be separated by commas, will appear in brackets ([]), and will
  17.     be followed by a question mark.  If you don't specify the /C switch,
  18.     choice uses YN as the default.  The colon (:) is optional.
  19.  
  20.  /N
  21.    Causes choice not to display the prompt.  The text before the prompt
  22.    is still displayed, however.  If you specify the /N switch, the
  23.    specified keys are still valid.
  24.  
  25.  /S
  26.    Causes choice to be case sensitive.  If the /S switch is not
  27.    specified, choice will accept either upper or lower case of the keys
  28.    that the user specifies.
  29.  
  30.  /T[:]c,nn
  31.      Causes choice to pause for a specified number of seconds before
  32.      defaulting to a specified key.  The values for the /T switch are
  33.      as follows:
  34.  
  35.        c   Specifies the character to display after nn seconds.  The
  36.            character must be in the set of choices specified by the /C
  37.            switch.
  38.  
  39.        nn  Specifies the number of seconds to pause.  Acceptable values
  40.            are from 0 to 99.  If 0 is specified, there will be no pause
  41.            before defaulting.
  42.  
  43.    text
  44.      Prompt string to display
  45.  
  46. RETURN VALUE
  47.  
  48.    ERRORLEVEL is set to offset of key user presses in choices.
  49.  
  50. AUTHOR
  51.  
  52.    Jim Hall, jhall@freedos.net
  53.  
  54.